home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / giftech.exe / GIF1.DOC < prev    next >
Text File  |  1988-01-15  |  6KB  |  116 lines
  1. GIF.EXE ver 1.1 by Bob Montgomery [CIS 73357,3140]           1-15-87
  2.  
  3. This is a GIF file viewer for EGA with the following features:
  4.      Very fast GIF decoding.
  5.      Menu driven for selecting file(s) to view; returns with cursor at last 
  6.           position.
  7.      Shows specified files like a slide show.
  8.      Cursor automatically moves to next file when marking in menu mode.
  9.      Creates PC Paint, ZSoft, or EGA PAint file from current pic.
  10.  
  11. The commands are:
  12. 1. gif [path\]filename[.ext]  to show a single file. The default path is the
  13.      current directory, and the default extension is GIF. 
  14.  
  15. 2. gif [.ext] to get a menu of up to 80 files in current dir with extension ext.
  16.      The default extension is GIF. This is handy if you have some pictures that
  17.      you don't want to come up in the normal menu; ie, adult and nude pics can
  18.      be renamed to ADL extension. 
  19.  
  20. 3. gif [#path\][filespec] to get a menu of all files in the specified path
  21.      meeting filespec (may contain wildcards). The default path is the current
  22.      directory, and the default filespec is *.GIF; thus just entering 'dg' will
  23.      give a menu of all GIF files in the current directory. The # was necessary 
  24.      to specify that a path is being requested. Consider the command 'dg \gif'. 
  25.      Does this say you want to view a GIF file named GIF in the root directory,
  26.      or does it say you want a menu of all GIF files in the subdirectory \GIF? 
  27.      The # makes clear that you want a menu of all GIF files in the subdrectory
  28.      GIF. Entering dg \gif\d*.adl would get a menu of all files starting with 
  29.      the letter d and having an extension adl in the subdirectory \GIF of the 
  30.      current drive. The only type commands it doesn't understand is a path of 
  31.      the form .\dir (indicating a subdir of the current dir); it does understand
  32.      a full filespec of the form .\dir\*.gif.
  33.  
  34. 4. gif @[path\]filename[.ext]  to do a slide show from commands in filename. The
  35.      default path is the current directory, and the default extension is SLD.
  36.      The commands are placed on seperate lines, and consist of either a filename
  37.      (GIF extension assumed), or a delay (viewing time) spec of the form  d n
  38.      where n is the desired viewing time in seconds. The default viewing time
  39.      is 5 seconds if no delay spec is given. Press ESCape to end the slide show.
  40.      Pictures that are 320 or less pixels wide are displayed double size.
  41.  
  42. 5. gif ?  gives a help screen.
  43.  
  44. The # and @ commands can both be given on the command line. The # specifies the
  45. path and filespec (* and ? OK) of the GIF picture files, and the @ specifies
  46. the path/filename of the slide file. The @ has higher precedence than #, and you
  47. will get a slide show. Thus, if the slide command file and the GIF files are in
  48. the \GIF directory, and you are somewhere else, you can do a slide show by
  49. either dg @\gif\cmds #\gif  or  dg #\gif @\gif\cmds.
  50.  
  51. The # and . commands can also be given on the same command line, where the #path
  52. specs the path and the .ext specs the extension to look for. This is the same
  53. as giving #path\*.ext
  54.  
  55. Commands in menu mode:
  56. 1.   The up, down, right, and left arrow keys move the cursor around the menu
  57.      of files.
  58. 2.   Pressing the spacebar marks a file for viewing and moves to the next file;
  59.      it will also unmark a previously marked file. 
  60. 3.   Pressing enter will display the marked files in the order they were marked.
  61.      If no files were marked, pressing enter displays the file at the cursor.
  62. 4.   Pressing ESCape ends the program and returns to DOS.
  63. All other keys are ignored. If errors are encountered, an error message appears
  64. on the next to last line, and disappears when the cursor is moved. 
  65. The menu title is the search spec.
  66.  
  67. Commands while viewing a file (except in slide mode):
  68. 1.   The up/down arrow keys will scroll the picture if longer than 350 lines.
  69. 2.   If it is 320 or less pixels wide, pressing 2 will give a double size image
  70. (which may be scrollable) and pressing 1 will give the normal size again.
  71. 3.   Pressing Z will create a ZSoft (PC Paintbrush) file with the same filename
  72.      and extension PCX. 
  73. 4.   Pressing P will create a PC Paint 2.0 file with the same filename and 
  74.      extension PIC. 
  75. 5.   Pressing R will create a RIX (EGA Paint) file with the same filename and 
  76.      extension SCR. 
  77. 6.   Pressing enter will return to menu or DOS, or show next file for marked
  78.      menu mode.
  79. 7.   Pressing ESCape will end the display and return to the menu.
  80. All other keys are ignored.
  81.  
  82. The program was first written in C, and then the following parts were rewritten
  83. in assembly language (which increased the speed by a factor of 2):
  84. 1.  GIF decoder for speed.
  85. 2.  EGA screen writing for speed.
  86. 3.  Part of PC Paint encoder for speed.
  87. 3.  File search module for menu mode, since can't do conveniently from C.
  88.  
  89. The program requires an IBM or compatable with at least 256K of RAM, and a EGA
  90. adapter (256K) and monitor. If you like and use the program, please support it
  91. by sending $10 to:
  92.  
  93.      Bob Montgomery
  94.      123 Parsons Road
  95.      Longwood, Fl 32779
  96.  
  97. This will encourage me to update the program periodically, and to upload other
  98. picture viewers/converters. The next program will be a PC Paint picture viewer
  99. which can save the EGA screen to ZSoft, RIX, and GIF files. The program took 
  100. about 1 month to write in its final form. If you use it, $10 is not much to pay
  101. for a useful tool; not much more than a typical session on a long distance
  102. BBS. Please don't rip me off. Any suggestions or comments can be mailed directly
  103. to me, or left on the following BBS's:
  104.      Compuserve
  105.      Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
  106.      PC Rockland, Nyack, NJ (914) 353-2176
  107.  
  108. Revision history:
  109. ver 1.1   1-13-87
  110.           Added test for EGA adapter.
  111.           Fixed menu colors.
  112.           Allow ESCape from marked file viewing.
  113.           Added Ctrl Break (or Ctrl C) exit to DOS anywhere.
  114.           Added 'disk full' notification when creating picture file.
  115.           Added critical error handler for 'drive not ready' errors.
  116.